home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / a_man / cat1m / cbeutil.z / cbeutil
Encoding:
Text File  |  2002-10-03  |  5.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ccccbbbbeeeeuuuuttttiiiillll((((1111mmmm))))                                                        ccccbbbbeeeeuuuuttttiiiillll((((1111mmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      cbeutil - CDB back-end database utility tool
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ccccbbbbeeeeuuuuttttiiiillll [ _o_p_t_i_o_n... ] _c_m_d...
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _c_b_e_u_t_i_l provides direct access to an individual back-end database that is
  16.      part of the Cluster Administration Services (CAS) configuration database
  17.      (CDB).  It does so by means of commands that correspond roughly to
  18.      functions in the CDB back-end API.  _c_b_e_u_t_i_l can read these commands from
  19.      command-line arguments, script files and interactively from the user.
  20.  
  21.      _c_b_e_u_t_i_l commands consist of a command name followed by zero or more
  22.      arguments and terminated by a semicolon or newline.  Individual arguments
  23.      are normally separated by whitespace; to include whitespace in a single
  24.      argument (e.g. a string value) enclose the argument in double quotes.  A
  25.      single argument or command can be continued across multiple lines in a
  26.      script file by ending intermediate lines with a backslash character.  If
  27.      the first non-whitespace character in a line is a "#" then the rest of
  28.      the line will be treated as a comment and discarded.
  29.  
  30.      Individual commands are documented online within _c_b_e_u_t_i_l.  For a list of
  31.      the commands, type "help" while in interactive mode, or "cbeutil help"
  32.      from the command line.
  33.  
  34. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  35.      _c_b_e_u_t_i_l takes several options:
  36.  
  37.      ----cccc _s_t_r_i_n_g   Process the single argument _s_t_r_i_n_g as a cbeutil command line.
  38.                  Multiple commands can be included on this command line by
  39.                  separating them with semicolons.  Unless _s_t_r_i_n_g is a single
  40.                  word, it will normally need to be enclosed in quotes so that
  41.                  it is treated as a single command-line argument by the shell.
  42.                  This option can be specified any number of times.
  43.  
  44.      ----ffff _p_a_t_h     Read cbeutil commands from the file _p_a_t_h.  This option can be
  45.                  specified any number of times.
  46.  
  47.      ----iiii          Switch to interactive mode after any commands specified on
  48.                  the command line and/or with the "-f" options have been
  49.                  processed.  Commands will be accepted from stdin until the
  50.                  "exit" command is issued or EOF is received.
  51.  
  52.      ----pppp          Print a prompt before accepting each command in interactive
  53.                  mode.  This is the default behavior; the option is provided
  54.                  primarily to undo a "-np" option earlier on the command line
  55.                  or in the CBEUTIL_OPTS environment variable (see below).
  56.  
  57.      ----qqqq          Turns on "quiet" mode: successful completion messages will
  58.                  not be printed, though error messages will continue to be
  59.                  printed as usual.  Note that the only purpose of some
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ccccbbbbeeeeuuuuttttiiiillll((((1111mmmm))))                                                        ccccbbbbeeeeuuuuttttiiiillll((((1111mmmm))))
  71.  
  72.  
  73.  
  74.                  commands is to print information (e.g. the value of a node),
  75.                  and this will not be affected by quiet mode.
  76.  
  77.      ----xxxx          Enables "expert" mode.  If this option is specified, then the
  78.                  "expert on" command can be used to turn on expert mode.  This
  79.                  will permit some additional operations that are usually not
  80.                  useful to ordinary users.
  81.  
  82.      --------          This will cause the rest of the command line to be treated as
  83.                  a single command string, with exactly one space between each
  84.                  of the remaining arguments.  Strictly speaking, the "--" is
  85.                  optional unless it is needed to resolve some ambiguity.
  86.  
  87.      Options can also be specified in the environment variable CCCCBBBBEEEEUUUUTTTTIIIILLLL____OOOOPPPPTTTTSSSS.
  88.      Options specified in this way will be processed before the options on the
  89.      command line itself.
  90.  
  91.      The "-i", "-p", "-q" and "-x" options can all be negated later on in the
  92.      command line by preceding the letter with "n".  For example, "-nq" will
  93.      turn _o_f_f quiet mode.  This may be useful to counteract an option
  94.      specified in CBEUTIL_OPTS.
  95.  
  96.      The "-c", "-f" and "--" options will be processed in the order they are
  97.      encountered.  If one of these input sources specifies multiple commands
  98.      and one of those commands should fail for some reason, the remainder of
  99.      the commands from that source will be discarded and processing will
  100.      continue with the next input source.  After all of those sources have
  101.      been exhausted, _c_b_e_u_t_i_l will enter interactive mode if the "-i" option
  102.      was specified.
  103.  
  104. NNNNOOOOTTTTEEEESSSS
  105.      The default location for the CBE database is /usr/lib/cdb/database/#.  To
  106.      specify a different location, set the environment variable CCCCBBBBEEEE____DDDDBBBB to the
  107.      pathname of the database file containing the root node.
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.